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❖ pti 

Void 

Void 

Void 
Void 

Void 

pti_evalres 
Void 
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Workload Model APIs 



workload 

Defme(pti_evlnameid, 
DOD) 

Defme(pti_evlist*,DOD) 

Eval(void) 

Eval(pti_elinark, 

pti_elmark) 

Eval(pti_elinark, 

pti_elinark, int, pti_evalalg) 

FlushResults 

FlushOtraces 



Specify a new event / workload using the event list name 
ID 

Specify a new event / workload using a pointer to the 
event list 

Evaluate all existing lists 

Evaluate a part of the event list specifying start and end 

Evaluate a part of the event list specifying start and end 
many times using the suggested evaluation algorithm 
Return overall result of evaluation 
Create output traces 



❖ pti_ddpar 




Void 


Add(pti_parref) 


Add a new data dependency parameter 


Void 


SetValue(pti_parref*' , void*) 


Set value to parameter 


pti_parref 


Search(string) 


Search dd parameter by name 


void* 


GetValue(pti_parref*) 


Get current value of dd parameter 


❖ pti_register 




Void 


Add(pti_mtype, void* , 


Add a new model to the system by defining it's type, 




Schema) 


pointer to its class, and related XML schema 


Void 


Delete(pti_mref) 


Delete model from system 


ptimref 


Search(pti_type,string) 


Search a specific type of model by name 


ptimref 


Search(string) 


Search all model by name 
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Hardware Model APIs 



❖ pti_hmod 




Void 


Reglnit 


Initialise hardware model (when registered) 


String 


GetName 


Name of model 


pti_parref 


GetParConfig 


Get model configuration parameters 


Schema 


GetParSchema 


Get model configuration XML schema for HMC DB 


pti_hmdev 


GetDeviceType 


Device type (Part of which device) 


pti_hniscope 


GetScope 


Scope of model (single or multiple events) 


pti_mref 


GetWorkloadType 


Workload type processed by the model 


pti mref 


GetOtraceType 


Extended trace output created by evaluation 


Void 


Eval(pti_event) 


Evaluate hardware model - for SEVENT scope 


Void 


Eval(pti_elinark, 


Evaluate hardware model - for MEVENT scope 




ptielmark) 



❖ pti_event 

DOD GetWorkload 

void SetEvalRes(pti_evalres) 

void SetOtrace(DOD) 

void AddEvent(pti_evlist* 
pti_evtype,DOD, 
pti_event*[]) 



Returns workload XML script 

Hardware model sets the result of evaluation 

Hardware model sets extended output trace as a resuh to 

evaluation 

Add new event at specified event list, specify type, XML 
workload, and pointers to related events (from and to). 



❖ pti_eviter 

ptievent* FirstEvent(pti_evlist*) 
ptievent* LastEvent(pti_evlist*) 
pti_event* NextEvent(pti_evlist*) 
pti_event* PreviousEvent(pti_evlist*) 

❖ pti_accevlist 

pti_evlist* Search(pti_evhiameid) 
pti_evlist* First(void) 
pti_evlist* Next(void) 
pti_evlist* Previous(void) 
ptievlist* Last(void) 



Access first element of the list 
Access last element of the list 
Access next element of the list 
Access previous element of the list 



Searches for an event list with a specified name ID* 
First event list 
Next event list 
Previous event list 
Last event list 



Hardv/are & Model Configuration APIs 



❖ pti_hmc 

Void Config(DOD) 



Output 

❖ pti_otrace 

Void SetFilter(void (*f)()) 

Void SetFile(string) 

Void SetMode(pti_otmode) 



Configure engine based on DOD configuration 



APIs 



Specify filter function for otraces 
Specify output filename 
Specify output trace mode 
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Data Types 



Schema - Represents the XML schema 

Details on the actual type depend on the schema definition language. 

DOD - Reference to XML Document Object Model 



❖ pti_mtype - Type of model 

1 0 Enumerated values: HRDMOD, WRKMOD,OTMOD 

❖ pti_hctype - Type of hardware model configuration parameter 

Enumerated values: INT, FLOAT, STRING 

15 ❖ pti_hmdev - Hardware device type 

Enumerated values: COMPUTER, NETWORK 

❖ pti^hmscope - Scope of hardware model 

SEVENT model process single event 

^ 20 MEVENT model process multiple events 

^ ❖ pti_mref- Reference to any model type 

r I pti_mtype model type 

y void* pointer to model access class 
25 Schema Schema to related XML DB 

yl 

ry ❖ pti_parref - Generic parameter reference (used for hardware model 
configuration and data dependency parameters) 

l_ string Name of parameters 

O 30 pti_hctype Type of parameter 

ffl void* Pointer to hrdmod variable 

=P ^♦^ pti_elmark - Mark specific positions of the event list (start or end of events) 

Q Not accessed directly through APIs (accessed through pti hmeliter defined at the hardware model 

0 35 API) 

❖ pti_evalres - The result of the evaluation of the hardware model for a single 
event 

ulong predicted time 

40 ulong best case predicted tx 

ulong worst case predicted tx 
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pti_evtype - Type of event 

PROCESS Processing or single event 
COMM Communication event (synchronous) 

ACOMM Asynchronous communication event 

SYNCH Synchronization event 

WAIT Wait for synchronization event 



pti_evlist - A single event list 

The event list is the main data structure used by the evaluation engine to represent a sequence of 
events that takes place for a modeled system, store the results of individual models, and combine 
these results into the overall system performance prediction. 

An event list is a single linked list representing events that take place on one of the system 
components (e.g. a single CPU or process). The event list is identified with the name id of the 
system component that it models. The elements of the list represent individual events. An event 
can be, by way of example, a computation, an I/O operation, a communication between 
computers, etc. Event interactions (e.g. process communications) are represented by pointers that 
may originate from the events that created the interactions and point to the target event(s). 



pti evlnameid - Name id is a string that determines one or more event lists 

The definition of an event list id is determined upon configuration of the system architecture at the 
KMC. Consider the following configuration script: 



<system name="pc_cluster"> 
<computer name="pc_node" count="16"> 
<!-- CPU Model C Operations --> 
Processes = 10 
Threads = 2 
<cpu_clc> 

<DILG>0 . 043</DILG> 
<IADD>0 . 127</IADD> 
<!-- Other operation follow 
</cpu_clc> 
< /computer > 

< ne twork name = " myr i ne t " > 

<ccmod> 

<Nproc > 1 6 < / Nproc > 

<-- other configuration follow --> 

</ ccmod> 
</network> 

< connect > 

<computer name="pc_node" node="l"> 
<network name="myrinet" port="l"> 

</connect> 

<!-- Connection to other nodes ... --> 
</ system> 



To refer to all pc nodes the event list name ID is "PC_NODE". To refer to one node 
"PC_NODE.l". To refer to specific thread "PC_NODE. 1.9.1". To refer to the network 
"MYRINET". Note: only the first part of the name ID is symbolic. 

The user may, if desired, define more than one system component by omitting a level of the ID 
description. For example "PC_N0DE.2" refers to all processes and threads of PC node 2. 
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pti_evalalg - Event list evaluation algorithm 

SIMULATION 

Is extendable to many algorithms 

pti_otmode - Define output trace modes 

BASIC Output basic output traces (dump of event list) 

EXTENDED Output hardware model extended traces 
METRICS Use filtering process to produce metrics 



APPENDIX END 
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